more moving options

diff --git a/xmldoc/formats/mapsource.xml b/xmldoc/formats/mapsource.xml
index aacfca2b2471f4849562b707238d38d55c7d5e93..31f4319ab187ce22e83b593e9ce705ef1e5fe273 100644 (file)
--- a/xmldoc/formats/mapsource.xml
+++ b/xmldoc/formats/mapsource.xml
@@ -1,31 +1,27 @@
-
-      
-      
-      <para> Garmin Mapsource format appears compatible with the
-various members of that product family.  Icon mapping is attempted
-between different MapSource versions.  Altitude is supported, but
-proximity and depth are not.  Naming files *.mps will allow
-file-&gt;open in Mapsource to find the files more easily.  Versions 3,
-4 and 5 of the Mapsource data format are handled automatically on
-input and by default the output is version 5.  (Until 3/2004, it was
+<para> 
+This format supports the Garmin <productname>Mapsource</productname>
+product family.
+</para>
+<para>
+This format is based on significant reverse-engineering and guesswork.
+GPSBabel's output appears to be compatible with the various versions of 
+MapSource.  Icon mapping is attempted between different MapSource versions.  
+Altitude is supported, but proximity and depth are not.  
+</para>
+<para>
+Naming files *.mps will allow file-&gt;open in Mapsource to find the files 
+more easily.  
+</para>
+Versions 3, 4, and 5 of the Mapsource data format are handled automatically 
+on input.  By default the output is version 5.  (Until 3/2004, it was
 version 3, but since Mapsource updates are free, the convenience of
 having modern icon sets outweighs the backward compatibility concern.
 Users of other versions can either upgrade or specify the switches to
-get get output in a compatible format.)  Waypoints, routes and
-tracklogs are all handled, but maps sets are ignored.
+get output in a compatible format.)  Waypoints, routes, and tracklogs are 
+all handled, but maps sets are ignored.
+</para>
+<para> 
+Information on the Garmin Mapsource format was provided by Ian Cowley and 
+Mark Bradley.  The code was implemented by Robert Lipe and Mark Bradley.
 </para>
-      <para> Information on the Garmin Mapsource format was provided
-by Ian Cowley and Mark Bradley.  The code was implemented by Robert
-Lipe and Mark Bradley.</para>
-      <para>Additional options:</para>
-      <para>
-            <option>snlen</option> - set the length of generated
-shortnames </para>
-      <para>
-            <option>mpsverout</option> - set the data format version
-of the output file (3,4 or 5) </para>
-      <para>
-            <option>mpsmergeout</option> - if the output file already
-exists, then the output is merged with it. This allows MapSource
-sections not being handled to remain intact (e.g. map sets)</para>
     

diff --git a/xmldoc/formats/options/mapsource-mpsmergeout.xml b/xmldoc/formats/options/mapsource-mpsmergeout.xml
index 8b137891791fe96927ad78e64b0aad7bded08bdc..8b06e42d229bb41790a68ef6ddb3bee131bf5646 100644 (file)
--- a/xmldoc/formats/options/mapsource-mpsmergeout.xml
+++ b/xmldoc/formats/options/mapsource-mpsmergeout.xml
@@ -1 +1,5 @@
-
+<para>
+This option causes the output to be merged with a pre-existing output file.
+This allows MapSource sections that aren't handled by GPSBabel (e.g. map sets)
+to be preserved.
+</para>

diff --git a/xmldoc/formats/options/mapsource-mpsusedepth.xml b/xmldoc/formats/options/mapsource-mpsusedepth.xml
index 8b137891791fe96927ad78e64b0aad7bded08bdc..08b6dfd34428156f96f60953575b9e70694529ec 100644 (file)
--- a/xmldoc/formats/options/mapsource-mpsusedepth.xml
+++ b/xmldoc/formats/options/mapsource-mpsusedepth.xml
@@ -1 +1,5 @@
-
+<para>
+This option causes GPSBabel to write depth values for waypoints.  Most 
+input formats do not support depth values, so the default is to not write
+them.
+</para>

diff --git a/xmldoc/formats/options/mapsource-mpsuseprox.xml b/xmldoc/formats/options/mapsource-mpsuseprox.xml
index 8b137891791fe96927ad78e64b0aad7bded08bdc..c09a64b5fbaa9894b6b8ffe216afa5fe788a5a39 100644 (file)
--- a/xmldoc/formats/options/mapsource-mpsuseprox.xml
+++ b/xmldoc/formats/options/mapsource-mpsuseprox.xml
@@ -1 +1,5 @@
-
+<para>
+This option causes GPSBabel to write proximity values for waypoints.  Most 
+input formats do not support proximity values, so the default is to not write
+them.
+</para>

diff --git a/xmldoc/formats/options/mapsource-mpsverout.xml b/xmldoc/formats/options/mapsource-mpsverout.xml
index 8b137891791fe96927ad78e64b0aad7bded08bdc..6aa3d7bbd097682a72b88aeba4a9b7a4a6bdde8d 100644 (file)
--- a/xmldoc/formats/options/mapsource-mpsverout.xml
+++ b/xmldoc/formats/options/mapsource-mpsverout.xml
@@ -1 +1,5 @@
+<para>
+This option specifies the format version for the output file.  The default
+is version 5, as noted above.  Supported versions are 3, 4, and 5.
+</para>
 

diff --git a/xmldoc/formats/options/mapsource-snlen.xml b/xmldoc/formats/options/mapsource-snlen.xml
index 8b137891791fe96927ad78e64b0aad7bded08bdc..40e49445314c9ff61b6631220d3c8f99e7c20592 100644 (file)
--- a/xmldoc/formats/options/mapsource-snlen.xml
+++ b/xmldoc/formats/options/mapsource-snlen.xml
@@ -1 +1,4 @@
-
+<para>
+This option specifies the length of generated short names on output.  The 
+default is 10 characters.
+</para>

diff --git a/xmldoc/formats/options/mapsource-snwhite.xml b/xmldoc/formats/options/mapsource-snwhite.xml
index 8b137891791fe96927ad78e64b0aad7bded08bdc..0655b1894f0dd915e2d55ca9fb1328efaf804346 100644 (file)
--- a/xmldoc/formats/options/mapsource-snwhite.xml
+++ b/xmldoc/formats/options/mapsource-snwhite.xml
@@ -1 +1,4 @@
-
+<para>
+This option specifies whether to allow whitespace (space, tab, etc.) in 
+generated short names on output.  The default is to not allow whitespace.
+</para>